Skip to main content

Crafty Controller

Crafty Controller ist ein Dashboard zur Verwaltung von Minecraft-Servern. Dieser Guide deckt die automatisierte Schnellinstallation sowie die detaillierte manuelle Einrichtung ab.

1. Voraussetzungen (Requirements)​

Bevor du startest, müssen folgende Bedingungen erfüllt sein:

  • Betriebssystem: Ubuntu/Debian oder CentOS[cite: 1].
  • Hardware-Zugriff: Sudo-Berechtigungen sind zwingend erforderlich[cite: 1].
  • Software-Basis: Git, Python 3.9+ (inkl. dev-Paketen) und python3-pip[cite: 1].
  • Java: Muss installiert sein, um Minecraft-Server innerhalb von Crafty zu starten[cite: 1].
  • Standard-Pfade: Crafty wird standardmäßig in /var/opt/minecraft/crafty installiert[cite: 1].

2. Methode A: Automated Install (Schnellstart)​

Die bequemste Methode für eine saubere Standard-Installation.

Vorbereitung​

Aktualisiere deine Pakete und installiere Git:

sudo apt update && sudo apt upgrade && sudo apt install git[cite: 1]

Installation ausführen​

Kopiere diesen One-Liner, um das Installations-Skript zu laden und zu starten:

git clone https://gitlab.com/crafty-controller/crafty-installer-4.0.git && \
cd crafty-installer-4.0 && \
sudo ./install_crafty.sh[cite: 1]

3. Methode B: Manuelle Installation (Deep-Dive)​

Falls du die Verzeichnisse selbst kontrollieren oder keinen automatischen Installer nutzen möchtest.

Schritt 1: Host-Abhängigkeiten (Ubuntu/Debian)​

sudo apt install git python3 python3-dev python3-pip software-properties-common openjdk-8-jdk openjdk-8-jre[cite: 1]

Schritt 2: Service-User & Verzeichnisse​

Erstelle einen dedizierten User für Crafty, um die Sicherheit zu erhöhen:

sudo useradd crafty -s /bin/bash[cite: 1]
sudo mkdir -p /var/opt/minecraft/crafty /var/opt/minecraft/server[cite: 1]
sudo chown -R crafty:crafty /var/opt/minecraft[cite: 1]

Schritt 3: Quellcode & Virtual Environment​

Wechsle in das Verzeichnis und bereite die Python-Umgebung vor:

cd /var/opt/minecraft/crafty[cite: 1]
git clone https://gitlab.com/crafty-controller/crafty-4.git[cite: 1]
python3 -m venv .venv[cite: 1]

Schritt 4: Paket-Abhängigkeiten installieren​

Wechsle zum Service-User und installiere die Requirements innerhalb der Venv:

sudo su crafty -[cite: 1]
source .venv/bin/activate[cite: 1]
cd /var/opt/minecraft/crafty/crafty-4[cite: 1]
pip3 install --no-cache-dir -r requirements.txt[cite: 1]

4. Betrieb & Verwaltung​

Starten (Manuell)​

Um Crafty manuell im Terminal zu starten (nachdem du zum User crafty gewechselt bist):

./run_crafty.sh[cite: 1]
# ODER innerhalb der Venv:
python3 main.py[cite: 1]

Systemd Service (Autostart)​

Wenn du während der Installation dem Service-File zugestimmt hast, nutzt du diese Befehle:

  • Dienst starten: sudo systemctl start crafty[cite: 1]
  • Boot-Autostart: sudo systemctl enable crafty[cite: 1]

5. Updates & Wartung​

Stoppe Crafty immer vollständig, bevor du ein Update durchführst.

  • Service stoppen: sudo systemctl stop crafty[cite: 1]
  • Update-Skript ausführen: 
    sudo -u crafty /var/opt/minecraft/crafty/update_crafty.sh[cite: 1]

Troubleshooting: Git-Konflikte​

Falls das Update wegen lokaler Dateiänderungen abbricht, setze das Verzeichnis zurück (Vorsicht: Eigene Code-Änderungen gehen verloren):

git reset --hard origin/master[cite: 1]